home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / zl2b0101.zip / ZIPLAB.DOC < prev    next >
Text File  |  1993-01-01  |  42KB  |  906 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.          
  13.          ▒▒▒▒▒▒▒▒▒▄ ▒▒▒▒▄ ▒▒▒▒▒▒▒▒▒▄ ▒▒▒▒▄       ▒▒▒▒▒▒▒▒▄  ▒▒▒▒▒▒▒▒▒▄
  14.           ▀▀▀▀▀▒▒█▀  ▒▒█▀  ▒▒█▀▀▀▒▒█  ▒▒█▀       ▒▒█▀▀▀▒▒█   ▒▒█▀▀▀▒▒█
  15.               ▒▒█▀   ▒▒█   ▒▒█   ▒▒█  ▒▒█        ▒▒█   ▒▒█   ▒▒█   ▒▒█
  16.             ▒▒▒█▀    ▒▒█   ▒▒▒▒▒▒▒▒█  ▒▒█        ▒▒▒▒▒▒▒▒█   ▒▒▒▒▒▒▒█▀
  17.            ▒▒█▀▀     ▒▒█   ▒▒█▀▀▀▀▀▀  ▒▒█        ▒▒█▀▀▀▒▒█   ▒▒█▀▀▀▒▒█
  18.           ▒▒█▀       ▒▒█   ▒▒█        ▒▒█   ▒▒▄  ▒▒█   ▒▒█   ▒▒█   ▒▒█
  19.          ▒▒▒▒▒▒▒▒▒▄ ▒▒▒▒█ ▒▒▒▒█      ▒▒▒▒▒▒▒▒▒█ ▒▒▒▒█ ▒▒▒▒█ ▒▒▒▒▒▒▒▒▒█
  20.           ▀▀▀▀▀▀▀▀▀  ▀▀▀▀  ▀▀▀▀       ▀▀▀▀▀▀▀▀▀  ▀▀▀▀  ▀▀▀▀  ▀▀▀▀▀▀▀▀▀
  21.                   ▒▒▒▒▒▒▒▒▒▄ ▒▒▒▒▄      ▒▒▒▒▄ ▒▒▒▒▄ ▒▒▒▒▒▒▒▒▄
  22.                    ▒▒█▀▀▀▒▒█  ▒▒█▀       ▒▒█▀  ▒▒█▀ ▒▒█▀▀▀▒▒█
  23.                    ▒▒█   ▒▒█  ▒▒█        ▒▒█   ▒▒█  ▒▒█    ▀▀
  24.                    ▒▒▒▒▒▒▒▒█  ▒▒█        ▒▒█   ▒▒█  ▒▒▒▒▒▒▒▒▄
  25.                    ▒▒█▀▀▀▀▀▀  ▒▒█        ▒▒█   ▒▒█    ▀▀▀▀▒▒█
  26.                    ▒▒█        ▒▒█   ▒▒▄  ▒▒█   ▒▒█  ▒▒▄   ▒▒█
  27.                   ▒▒▒▒█      ▒▒▒▒▒▒▒▒▒█  ▒▒▒▒▒▒▒▒█  ▒▒▒▒▒▒▒▒█
  28.                    ▀▀▀▀       ▀▀▀▀▀▀▀▀▀   ▀▀▀▀▀▀▀▀   ▀▀▀▀▀▀▀▀
  29.                               ▒▒▒▒▒▒▄     ▒▒▒▒▒▒▄
  30.                                ▀▀▀▒▒█     ▒▒█▀▒▒█
  31.                               ▒▒▒▒▒▒█     ▒▒█ ▒▒█
  32.                               ▒▒█▀▀▀▀     ▒▒█ ▒▒█
  33.                               ▒▒▒▒▒▒▄ ▒▒▄ ▒▒▒▒▒▒█
  34.                                ▀▀▀▀▀▀  ▀▀  ▀▀▀▀▀▀
  35.  
  36.                     Copyright (C)1989-93 by Jeffrey S. Morley
  37.                     
  38.                                
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                                                              
  60.                                                                              
  61.                                                                              
  62.                                                                              
  63.                                                                              
  64.                                                                              
  65.                                                                              
  66.                                                                              
  67.                                                                              
  68.                                                                              
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.                                                                              
  77.                                                                              
  78.                                                                              
  79.                                                                              
  80.                                                                              
  81.                                                                              
  82.                                                                              
  83.                                                                              
  84.                                                                              
  85.                                                                              
  86.                                                                              
  87.                                                                              
  88.                                                                              
  89. ZipLab PLUS Version 2.ß.1
  90. (C)Copyright 1989-93 by Jeffrey S. Morley
  91. January 1st, 1993
  92.  
  93. Archive testing and maintenance program for PCBoard/ProDoor Sysops.
  94.  
  95.     
  96.  
  97.                                
  98. ##############################################################################
  99.                             Table of Contents
  100. ##############################################################################
  101.  
  102.        To jump to a section, do a search on the page number in the format:
  103.                  "Pgx" where "x" is the page number to jump to.
  104.  
  105.  
  106. Introduction to ZipLab Plus 2.0 ......................................... Pg1
  107.  
  108. Installation of ZipLab / Requirements ................................... Pg2
  109.  
  110. Installation of ZipLab / Quick Start .................................... Pg3
  111.  
  112. Installation of ZipLab / A Sample Configuration File .................... Pg7
  113.  
  114. Installation of ZipLab / Configuration Details .......................... Pg8
  115.                          I.   Conference Specific Configurations ........ Pg8
  116.                          II.  ZLABxxx.TCN trashcan file(s) .............. Pg9
  117.                          III. ZLABxxx.CMT comment file(s) ............... Pg9
  118.                          IV.  CRC.ADS ................................... Pg9
  119.                          V.   LST.ADS ................................... Pg10
  120.                          VI.  *.MSG The Message Files ................... Pg10
  121.  
  122. Installation of ZipLab / Usage Notes and Warnings ....................... Pg12
  123.                          I.   Command Line Parameters ................... Pg12
  124.                          II.  PCBoard's TEMP Directory .................. Pg12
  125.                          III. ZipLab's WORK Directory ....................Pg13
  126.  
  127. Installation of ZipLab / Some Notes on Memory Usage ..................... Pg14
  128.  
  129. Installation of ZipLab / ProDoor Differences ............................ Pg15
  130.  
  131. ZipLab Plus Version History ............................................. Pg16
  132.  
  133. About ZipLab Plus and the Author ........................................ Pg17
  134.  
  135.  
  136.                                                                            Pg1
  137.  
  138. ##############################################################################
  139.                        INTRODUCTION TO ZIPLAB PLUS  
  140. ##############################################################################
  141.  
  142. What is ZipLab Plus?
  143.  
  144. ZipLab Plus is a shareware program which will test archived files.  In 
  145. addition, ZipLab will allow you to add .ZIP comments, strip out unwanted 
  146. members, and much, much more!  ZipLab was designed for PCBoard/ProDoor 
  147. SysOps, to test files as they are uploaded to their systems.  It is run in 
  148. the PCBTEST.BAT file which comes with PCBoard 14.5.  PCBTEST.BAT is run by 
  149. PCBoard when an upload completes.
  150.  
  151.  
  152. The following is a quick list of ZipLab's features:
  153.  
  154. Testing:  
  155. * Test for CRC errors in the archive file.
  156. * Test for imbedded archive files and if found, CRC check those too.
  157. * Test for imbedded .TD0 (Teledisk) files and if found, test with TDCHECK.
  158. * Virus SCAN archive member files, using SCAN.EXE from McAffey.
  159. * SCAN inside archive files imbedded inside another archive file.
  160. * Test .GIF files for validity if you accept that file format (Optional)
  161. * Run SCAN on files which you optionally pass without ZIP testing.
  162. * Reject programs older than a date (yyyymm) which you specify.
  163. * Uses a "trashcan" file to reject by description keywords you specify.
  164. * Will fully test "self-extracting" archives of the ZIP/ARJ/LZH formats.
  165.  
  166. Maintenance:
  167. * Remove all archive comments from the file.
  168. * Replace archive comments with your own. (Optional)
  169. * Add the contents of FILE_ID.DIZ to the archive comment.
  170. * Use special ZipLab "@" codes to include test information in the comment.
  171. * Adds the reasons to the comment on files which fail ZipLab Plus testing.
  172. * Delete unwanted BBS ads and/or other unwanted archive members as you define.
  173.   - ZipLab tests for BBS ads by FILENAME or file CRC. 
  174. * Allows you to optionally add a file to the archive.
  175.  
  176. PCBoard/ProDoor BBS specific features:
  177. * Add the resolution of .GIF files to the description (Optional)
  178. * Adds most recent archive member date to the description (Optional)
  179. * Optionally replace the description left by the user if FILE_ID.DIZ is
  180.   found in the archive file.
  181. * Will make a notation in both the CALLER file and the private DIRx 
  182.   file for the current node of any files which fail upload testing, 
  183.   including the failure reason.
  184. * Allows your users to run the TEST command in PCBoard to test files, 
  185.   but ZipLab will not remove the file unless it fails CRC or virus 
  186.   checking. You will be notified via the node's CALLER file of 
  187.   archives which fail PCBoard's TEST command, and why.
  188. * Takes the phone "offhook" if the user hangs up before/during testing.
  189. * Sends a mail message to the user letting him know why a file was
  190.   rejected, and to both the user and the Sysop when a virus is found.
  191. * Allows full conference specific configurations.
  192.   
  193. General:
  194. * Run the full range of tests on .ZIP, .LHZ and .ARJ archive formats
  195. * Works on a PCBoard/ProDoor BBS in both online and local modes.
  196. * Works with both the old and new versions of PKZip.
  197.  
  198.   
  199.                                                                            Pg2
  200.  
  201. ##############################################################################
  202.                          ZIPLAB PLUS REQUIREMENTS                 
  203. ##############################################################################
  204.  
  205.  ! YOU MUST BE RUNNING PCBOARD VERSION 14.5(a) OR PRODOOR VERSION 3.44 !
  206.  
  207. You must have the following programs.  Several are included in the ZipLab 
  208. Plus archive, but registration of ZipLab DOES NOT include registration of 
  209. any of these products.  Please SUPPORT SHAREWARE and register these products 
  210. with their respective authors.
  211.  
  212. PKZIP.EXE   - Phil Katz's archive create program (version 1.01 or 1.93)
  213. PKUNZIP.EXE - Phil Katz's archive extract program (version 1.01 or 1.93)
  214. LHA.EXE     - Yoshi's archive program (version 2.13 +)
  215. ARJ.EXE     - Robert Jung's archive program (version 3.00 +)
  216. SCAN.EXE    - McAffey's virus detection program (any version)
  217. RECOM.EXE   - Mike Loewen's ZIP file comment remover
  218. GIFTEST.EXE - Dave Navarro's .GIF file tester (optional)
  219. TDCHECK.EXE - .TD0 (Teledisk) checker from SyDex (optional)
  220.  
  221. VBDTR10.EXE - RunTime module for Visual Basic for DOS.  You will need
  222.               this module in a directory in your DOS PATH to run
  223.               ZSET.EXE.  Free from Microsoft Inc.
  224.  
  225. Programs I have written and which are part of the ZipLab Plus package.
  226.  
  227. DELF.COM    - A version of DEL with no "Are you sure?" prompt.
  228. ZLSCR.COM   - A little utility called by ZipLab to help handle the
  229.               local screen during testing (Based on ProNS.COM by
  230.               Sam Smith).
  231. ZCRC.EXE    - A small utility to get file CRC values for placement in your
  232.               ADS.CRC file.
  233. ZLAB.EXE    - The ZipLab Plus executable program.
  234. ZSET.EXE    - The ZipLab Plus setup/configuration maintenance program.
  235.  
  236.  
  237.                                                                            Pg3
  238.  
  239. ##############################################################################
  240.                                QUICK START 
  241. ##############################################################################
  242.  
  243. * ZipLab does a LOT of things.  It is a complicated program, but a breeze
  244.   to set up and run... IF you follow the directions and read this entire
  245.   documentation.  Print this document and follow it step by step.  You
  246.   can't miss.
  247.   
  248. * Create a directory to hold ZLAB.EXE, the sample ZLAB000.CFG, 
  249.   ZLAB000.TCN, CRC.ADS, LST.ADS, *.MSG, ZLAB000.CMT and ZSET.EXE 
  250.   files.  This directory should be in your DOS PATH.  All ZipLab files 
  251.   can be shared by multiple nodes.  Node specific configurations are 
  252.   not required.  Let's assume you use C:\ZIPLAB for now.
  253.  
  254. * UnZIP the enclosed supplemental utilities into directories in your DOS 
  255.   PATH. Make note of where you put them, you will need this information 
  256.   later.  Make sure VBDRT10.EXE is in your DOS PATH.
  257.  
  258. * Run "ZSET.EXE ZLAB000.CFG".  ZSET will then start with the default 
  259.   configuration, ZLAB000.CFG, which you should modify to meet your system's 
  260.   needs.  The "000" in the config name is conference specific.  The default 
  261.   is for conference "0", the "Main Board". More later on how to create 
  262.   conference specific configurations. for now, ZipLab will default to 
  263.   looking for ZLAB000.CFG when run from any conference.
  264.   
  265. * Modify the following information for your system ,in ZLAB000.CFG:
  266.  
  267.      1  -  The type of modem HANDSHAKE you desire.  This can be 
  268.            0, 1, 2 or 3.  0=none, 1=XON/XOFF, 2=CTS, 3=CTS & XON/XOFF
  269.            (Use 2 or 3 with an error correcting modem...)
  270.            DEFAULT = 3
  271.         
  272.      2  -  The name of your BBS system.  43 characters maximum.
  273.            DEFAULT = THE INTERCONNECT BBS
  274.            
  275.      3  -  The DRIVE and PATH to the directory where rejects will be
  276.            placed pending manual sysop inspection.  This can be a 
  277.            common directory on multiple node systems, but SHOULD be
  278.            an empty (existing) directory dedicated to this purpose.
  279.            I recommend "d:\FAIL" or "d:\HOLD" as likely names.
  280.            DEFAULT = C:\FAIL
  281.            
  282.      4  -  The full DRIVE\PATH\FILENAME of your ZLAB000.TCN (trashcan)
  283.            file.  The filename need not follow the ZLABxxx.ext format,
  284.            but it will make conference specific work much easier later.
  285.            DEFAULT = C:\ZIPLAB\ZLAB000.TCN
  286.            
  287.      5  -  The date (yyyymm) which will be the minimum accepted year.  ZIPs
  288.            containing files older than this will be rejected.  Example:
  289.            199001 would mean any file older than January, 1990 would fail.
  290.            DEFAULT = 199001
  291.         
  292.      6  -  A "Y" if you wish to replace the description left by the user
  293.            with the contents of FILE_ID.DIZ (if found in the archive).
  294.            A "N" if you do not wish to make use of this feature.
  295.            DEFAULT = Y   
  296.  
  297.                                                                            Pg4
  298.      
  299.      7  -  A "Y" if you wish the "recent date" notation added to the file
  300.            descriptions.  A "N" if you do not wish this addition.
  301.            DEFAULT = Y
  302.         
  303.      8  -  A "Y" if you wish the "number of archive member files" notation
  304.            added to the file descriptions.  A "N" if you do not.
  305.            DEFAULT = Y
  306.         
  307.      9  -  A "Y" if you wish ZipLab to send a mail message to the user
  308.            when a file fails testing.  A "N" if not.
  309.            DEFAULT = Y
  310.         
  311.      10 -  A "Y" if you wish the sysop to also receive a mail message in
  312.            the instance of a virus detection.  A "N" if you do not. 
  313.            DEFAULT = Y
  314.         
  315.      11 -  The DRIVE\PATH\ to the directory which will hold the .MSG files.
  316.            These are the mail messages sent to the user/sysop on failure.
  317.            Please put a "\" at the end of the path.
  318.            DEFAULT = C:\ZIPLAB\
  319.            
  320.      11 -  The full DRIVE\PATH\FILENAME of a zip comment to add.  Again,
  321.            it is recommended that the name ZLAB000.CMT be used for
  322.            consistancy.  Specify "NONE" if you don't want to add a comment.
  323.            DEFAULT = C:\ZIPLAB\ZLAB000.CMT
  324.         
  325.      12 -  A "Y" if ZipLab should add the contents of FILE_ID.DIZ (if
  326.            found) to the bottom of the zip comment.  "N" to disable.
  327.            DEFAULT = Y
  328.         
  329.      13 -  The fully qualified filename of a file which you may wish to
  330.            add to the .ZIP, or "NONE" (please!) if you can refrain from
  331.            this practice. Once again, ZLAB000.ADD will make sense later.
  332.            DEFAULT = NONE
  333.         
  334.      14 -  Full DRIVE:\PATH\FILENAME of PKZIP.EXE.
  335.            DEFAULT = C:\UTILITY\PKZIP.EXE
  336.         
  337.      15 -  Full DRIVE:\PATH\FILENAME of PKUNZIP.EXE.
  338.            DEFAULT = C:\UTILITY\PKUNZIP.EXE
  339.         
  340.      16 -  Full DRIVE:\PATH\FILENAME of LHA.EXE.
  341.            DEFAULT = C:\UTILITY\LHA.EXE
  342.         
  343.      17 -  Full DRIVE:\PATH\FILENAME of ARJ.EXE.
  344.            DEFAULT = C:\UTILITY\ARJ.EXE
  345.  
  346.      18 -  Full DRIVE:\PATH\FILENAME of TDCHECK.EXE.
  347.            (or "NONE" if not using)
  348.            DEFAULT = C:\UTILITY\TDCHECK.EXE
  349.         
  350.      19 -  Full DRIVE:\PATH\FILENAME of SCAN.EXE.
  351.            DEFAULT = C:\UTILITY\SCAN.EXE
  352.         
  353.      20 -  Full DRIVE:\PATH\FILENAME of RECOM.EXE.
  354.            DEFAULT = C:\UTILITY\RECOM.EXE
  355.  
  356.                                                                            Pg5
  357.         
  358.      21 -  Full DRIVE:=PATH\FILENAME of DELF.COM
  359.            DEFAULT = C:\UTILITY\DELF.EXE
  360.         
  361.      22 -  Full DRIVE:\PATH\FILENAME of GIFTEST.EXE
  362.            (or "NONE" if not using)   
  363.            DEFAULT = C:\UTILITY\GIFTEST.EXE
  364.         
  365.      23 -  Command line PARAMETERS you wish to pass to GIFTEST.EXE
  366.            Please refer to the documentation for GIFTEST for details!
  367.            Just enter "NONE" if you do not desire to use GIFTEST.  
  368.            DEFAULT = NONE
  369.         
  370.      24 -  A list, all on one line, (separated by ";" - EXE;TXT;GIF) 
  371.            Which will be passed without normal ZIP testing.  SCAN and 
  372.            date checking will still be performed on these files.  Any 
  373.            extensions other than ZIP/ARJ/LZH which do not appear in 
  374.            this list will be rejected by the process. If GIF appears 
  375.            in this list, GIFTEST will be used to test the integrity of 
  376.            the GIF file. If you enter a "*" as one of the extentions, 
  377.            then ALL files will be passed through, with non-archived 
  378.            files being SCAN'd and date checked only. "NONE" in this
  379.            position will only allow ZIP/ARJ/LZH files to pass.
  380.            DEFAULT = GIF;EXE;PCX
  381.         
  382.      25 -  The full DRIVE/PATH/FILENAME of a text file containing the 
  383.            file CRC for files you wish removed before posting the 
  384.            archive.  This file can be called anything, but LST.ADS 
  385.            works for me. You can use the included ZCRC.EXE to help 
  386.            maintain this file.  More on the use of ZCRC.EXE later.
  387.            DEFAULT = C:\ZIPLAB\CRC.ADS
  388.         
  389.      26 -  The full DRIVE/PATH/FILENAME of a text file containing the 
  390.            NAMES (one on each line) of files you wish removed before 
  391.            posting the archive. This file can be called anything you 
  392.            wish, I suggest CRC.ADS.  Any files listed in this text 
  393.            file which exist in the uploaded archive will be removed.
  394.            DEFAULT = C:\ZIPLAB\LST.ADS
  395.         
  396. * Click on the "SAVE" button in ZSET.EXE, and save under the ZLAB000.CFG
  397.   filename.
  398.   
  399. * Edit your existing PCBTEST.BAT file, and delete the whole thing except 
  400.   for two lines:
  401.   
  402.   Sample PCBTEST.BAT file:
  403.   
  404.   @ECHO OFF
  405.   C:\ZIPLAB\ZLAB.EXE %1 C:\PCB C:\ZIPLAB %2
  406.                      ^1 ^2     ^3        ^4
  407.   
  408.   1)  %1         PCBoard will populate this with the DRIVE\PATH\FILE to test.
  409.   2)  C:\PCB     The PCBoard "home" directory for the node.
  410.   3)  C:\ZIPLAB  The directory containing your ZLABxxx.CFG file(s).
  411.   4)  %2         PCBoard will populate this with TEST if a user is running
  412.                  the TEST command on the board.  You can also pass LOCAL 
  413.                  to this parameter to run ZipLab from DOS.
  414.  
  415.                                                                            Pg6
  416.                             
  417. * Note!  Although ZipLab can share its configuration files, it should be run 
  418.   FROM the PCBoard "home" directory of each node.  Do not change directories 
  419.   in PCBTEST.BAT to your "ZIPLAB" directory.
  420.  
  421. * That's it... Now when PCBTEST.BAT is run by PCBoard, it will pass command 
  422.   over to ZLAB.EXE with the parameter containing the path and name of the 
  423.   file to be tested.  ZLAB will check out the file, placing any rejects in 
  424.   the holding directory you specified in the ZSET process above.  
  425.  
  426.  
  427.                                                                            Pg7
  428.  
  429. ##############################################################################
  430.                        A SAMPLE ZLAB000.CFG FILE
  431. ##############################################################################
  432.  
  433.                      2                                      
  434.                      The Interconnect Bulletin Board System 
  435.                      C:\FAIL                                
  436.                      C:\ZIPLAB\ZLAB000.TCN                  
  437.                      199001                                 
  438.                      Y                                      
  439.                      Y                                      
  440.                      Y                                      
  441.                      Y                                      
  442.                      Y                                      
  443.                      C:\ZIPLAB\ZLAB000.CMT                  
  444.                      Y                                      
  445.                      NONE                                   
  446.                      C:\UTILITY\PKZIP.EXE                   
  447.                      C:\UTILITY\PKUNZIP.EXE                 
  448.                      C:\UTILITY\LHA.EXE                     
  449.                      C:\UTILITY\ARJ.EXE                     
  450.                      C:\UTILITY\TDCHECK.EXE                 
  451.                      C:\UTILITY\SCAN.EXE                    
  452.                      C:\UTILITY\RECOM.EXE                   
  453.                      C:\UTILITY\DELF.COM                    
  454.                      C:\UTILITY\GIFTEST.EXE                 
  455.                      /B:2 /F:UPDESC.2                       
  456.                      GIF;EXE;PCX                            
  457.                      C:\ZIPLAB\CRC.ADS                      
  458.                      C:\ZIPLAB\LST.ADS                      
  459.  
  460.  
  461.                                                                            Pg8         
  462.  
  463. ##############################################################################
  464.                            CONFIGURATION DETAILS       
  465. ##############################################################################
  466.  
  467. I.   Conference Specific Configurations
  468.  
  469. You MUST at least have created a file name ZLAB000.CFG for ZipLab Plus to 
  470. operate.  The "000" tells ZipLab that this is the configuration file for the 
  471. Main Board Conference, but is also the default for any conferences that do 
  472. not have specific configuration files. 
  473.  
  474. To create a configuration for another conference (let's use your "GAMES" 
  475. conference, number "5", as an example), run ZSET ZLAB000.CFG to bring in 
  476. your default configuration file, and then modify the file to be specific to 
  477. your Games Conference.
  478.  
  479. You can change just about every configuration item to be specific to the 
  480. Games conference.  Some things you might want to change are:
  481.  
  482. * The "Board Name" field - Maybe It will say "Joes BBS - Games Conference"
  483. * The name of your .TCN (trashcan) file.  You may want to exclude more
  484.   (or less) types of files from this conference.  Just call the file
  485.   ZLAB005.TCN.
  486. * The "Date Limit" field.  Maybe you want only the LATEST games.
  487. * The "Zip Comment" field.  Have a conference specific .ZIP comment by
  488.   changing the name to ZLAB005.CMT.
  489. * The use (or non-use) of GIFTEST.EXE, and the acceptance of .GIF files.  
  490.  
  491. Once you have modified the configuration to your satisfaction, just click on 
  492. "SAVE".  You will be presented with a "windows-ish" file save dialog window.  
  493. Change the name of the file to ZLAB005.CFG in the input field labeled "File 
  494. will be saved as:", and click on "OK"
  495.  
  496. (To edit this configuration file at a later time, just run ZSET.EXE with the 
  497. name of the configuration file as a parameter.  "ZSET ZLAB005.CFG")
  498.  
  499. Make further changes for other conferences you wish to set up, and save 
  500. under their respective names(up to 999 conferences).  When done, exit 
  501. ZSET.EXE.  
  502.  
  503. * Note!  Be sure that any files like ZLAB005.TCN or ZLAB005.CMT that you 
  504.   specify actually do exist!  You can create them before or after you run 
  505.   ZSET.EXE, but certainly before you run ZipLab Plus (unless you want to 
  506.   test my error handling system <g>).   
  507.  
  508.  
  509. II.  ZLABxxx.TCN  The "trashcan" file(s)
  510.  
  511. This file holds text key-words or key-phrases which are used to reject
  512. files based on either the filename or contents of the file description.
  513. If you for instance did not want "adult" .GIF files uploaded to your 
  514. system, but did want to allow other .GIF file uploads, you might put the
  515. following lines in ZLAB000.TCN:
  516.  
  517. ADULT
  518. X-RATED  
  519. "X RATED"
  520. MARGARINE
  521. "KITCHEN TABLE"
  522.  
  523.  
  524.                                                                            Pg9
  525.  
  526. Or whatever you feel would allow ZipLab to identify the kind of files you 
  527. have in mind, without being so generic as to cause perfectly acceptable 
  528. files to fail.
  529.  
  530. ZipLab Plus will test the filename, user supplied description, and the 
  531. contents of FILE_ID.DIZ (if found) against this list, and will reject any 
  532. files which contain these "trashcan" words/phrases.
  533.  
  534. * Note!  To imbedd "white space" either in, before, or after an entry, use 
  535.   the QUOTE (") character to surround the phrase or word. For instance, if 
  536.   you wanted to exclude files with the word "WIN" in them, you should use
  537.   " WIN " so that things like "TWIN" or "WINNER" don't also fail.
  538.  
  539.   
  540. III. ZLAB000.CMT  The "comment" file(s)
  541.  
  542. This is a text file which will be added as a .ZIP (or .ARJ) comment to
  543. the archive file.  As you can see from the filename format, you can
  544. certainly have a different comment file for each conference if you so
  545. desire.
  546.  
  547. This file can say anything you want.  I have also included some ZIPLAB-
  548. specific "@ZCODES" which can be imbedded in the text to add information
  549. which ZipLab Plus will provide at run-time.  You may NOT use PCBoard's
  550. "@-Codes", only the ones that ZipLab Plus supplies:
  551.  
  552. @ZCODE      MEANING              FORMAT / ADDITIONAL DESCRIPTION
  553.  
  554. @F_N@       File Name            "filename.ext"
  555. @A_T@       Archive Type         ".ZIP", ".ARJ", or ".LZH"
  556. @D_T@       Date Tested          "mm/dd/yyyy"
  557. @T_T@       Time Tested          "hh:mm:ss"
  558. @B_N@       Board Name           from ZLABxxx.CFG
  559. @U_N@       User Name            "firstname lastname"
  560. @N_O_F@     Number of Files      count of files in archive
  561. @N_F@       Newest File          "mm/dd/yyyy"
  562. @O_F@       Oldest File          "mm/dd/yyyy"
  563. @P_F_S@     Pass-Fail Status     "passed" or "failed"
  564. @R_F@       Reason for Failure   "CRC checking" , "Virus checking" etc...
  565. @T_C_T@     Trash Can Text       Text which failed .TCN checking - if any.
  566. @V_N@       Version Number       Version of ZipLab Plus ("2.0")
  567. @D_L@       Date Limit           "mm/dd/yyyy"
  568. @F_I_F@     FILE_ID.DIZ Found    "found" or "not found"
  569. @N_N@       Node Number          BBS node number
  570. @C_N@       Conference Number    conference the user is in (as a number)
  571.  
  572. * Note!  You may also use the word "ZIPLAB" in this field in ZLABxxx.CFG, 
  573.   and ZipLab will create a comment for you, with much of the above 
  574.   information. As always, you may also use "NONE", and ZipLab will not add 
  575.   any comment at all.
  576.  
  577.  
  578. IV.  CRC.ADS
  579.  
  580. This file will contain the file CRC-32 values (and names) of files which
  581. you wish removed from the archive prior to posting.  The format of the
  582. file is:
  583.  
  584. 00000000,filename.ext
  585.  
  586.  
  587.                                                                           Pg10
  588.  
  589. Where "00000000" is the file's CRC-32, and filename.ext is one of the 
  590. names by which the file is known.  The filename is not optional, but
  591. can really be anything, as ZipLab could care less what a file is called.
  592. If it matches on the CRC-32 value, it WILL be removed.
  593.  
  594. You will want to maintain your CRC.ADS file using the ZCRC.EXE file which is 
  595. included in the ZipLab Plus archive.  Just type:
  596.  
  597. "ZCRC [d:\path\]CRC.ADS [d:\path\]filename.ext" 
  598.  
  599. and ZCRC.EXE will place the proper information for the filename you replace
  600. "filename.ext" with at the bottom of the CRC.ADS file.
  601.  
  602. As always, a "NONE" in the ZLABxxx.CFG file in this position will cause 
  603. ZipLab Plus to skip this process.
  604.  
  605. * Note!  It is certainly acceptable to have different "CRC.ADS" files for 
  606. different confereneces, and you could use the "ZLABxxx.ADS" convention if 
  607. you wish.  I find that trying to maintain multiple versions of this file to 
  608. be a fair amount of trouble however, and don't particuarly recommend it.
  609.  
  610.  
  611. V.   LST.ADS
  612.  
  613. This is a text file (one on each line) containing only the names of files
  614. you wish removed without testing.  The difference between this file and
  615. the CRC.ADS file is that you can test for a particular file name, and it
  616. will remove it even if the person adding the file changes the contents 
  617. from time to time.  This file also supports "wildcards", so you can test
  618. for those names where "special" characters (above 126 ASCII) have been
  619. used to create a filename, by masking out those characters.
  620.  
  621. As an example, you could test for a BBS ad called "S£ïMΣ.Pïτ" by adding
  622. "S??M?.P??" as an entry in LST.ADS (of course, "SIMMS.PAS" would fail
  623. as well, so be careful how you use wildcards.).
  624.  
  625. Use "NONE" in the field in ZLABxxx.CFG to disable this feature.
  626.  
  627. * Note!  This file can contain up to 100 lines in version 2.0.
  628.  
  629.  
  630. VI.  *.MSG  The mail message files
  631.  
  632. The mail message files are text files (again, the @ZCodes can be used)
  633. which will consitute mail messages sent to the user when a file fails.
  634. This can be used to tell the user the reason for the rejection, to
  635. remind him of rules you may have about types of file you accept, or
  636. to reassure him that you still love him even though his file did have
  637. a CRC error <g>.
  638.  
  639. Remember when modifying or creating these files, that there are limits
  640. on mail messages in PCBoard.  Also, be sure to leave enough room for
  641. any @ZCodes to expand to actual values without running longer than
  642. 78 characters per line.
  643.  
  644. The files MUST have the names below, and samples of all the files are
  645. included in this archive.  These files should be in a central location,
  646. perhaps the C:\ZIPLAB directory where you have the .TCN, .CMT and other
  647. ZipLab files is best.  One of the entries in the ZLABxxx.CFG files will
  648. let you tell ZipLab where to find these files.
  649.  
  650.                                                                           Pg11
  651.  
  652. The files (and failure reasons) that ZipLab Plus uses are:
  653.  
  654. NAME OF FILE      REASON FOR FAILURE 
  655. ------------      ------------------
  656. OLDDATE.MSG       Failed date limit checking
  657. FILECRC.MSG       Failed CRC or -AV checking
  658. IMBEDCRC.MSG      An imbedded archive failed CRC or -AV checking
  659. TRASHCAN.MSG      .TCN (Trashcan) text was found in the description
  660. BADTD0.MSG        A Teledisk format (.TD0) file failed TDCHECK
  661. USRVIRUS.MSG      Message sent to USER on virus detection
  662. SYSVIRUS.MSG      Message sent to SYSOP on virus detection
  663. UNACCEPT.MSG      An unaccepted file format was uploaded
  664. GIFFAIL.MSG       A .GIF file failed GIFTEST
  665.  
  666. DO NOT RENAME THESE FILES!
  667.  
  668.  
  669.  
  670.                                                                           Pg12
  671.  
  672. ##############################################################################
  673.                          USAGE NOTES AND WARNINGS
  674. ##############################################################################
  675.  
  676. I.   Command line parameters -
  677.  
  678. ZLAB.EXE has the following commmand syntax:
  679.  
  680. ZLAB d:\path\filename d:\pcbpath d:\cfgpath [LOCAL|TEST]
  681.  
  682. d:\path\filename - The file to test, normally passed by PCBoard.
  683. d:\pcbpath       - The "home" PCBoard directory for this node.
  684. d:\cfgpath       - The directory containing your ZLABxxx.CFG files.
  685. LOCAL            - Causes ZipLab to function without any output to the 
  686.                    comm port.  Use this for testing files already on your 
  687.                    hard drive, or that you have downloaded yourself and 
  688.                    wish to post.  No changes will be made to any DIRx 
  689.                    files.
  690. TEST             - PCBoard will pass this as %2 if you are using the TEST 
  691.                    command inside PCBoard.  Files will only be moved to 
  692.                    the "hold" directory if they fail CRC or Virus 
  693.                    checking.  No changes will be made to any DIRx files.  
  694.                    Normal comm port output.                   
  695.  
  696. ZSET.EXE has the following command syntax:
  697.  
  698. ZSET [d:\path\configname.cfg]
  699.  
  700. [d:\path\]       - If you are not in the directory containing the .CFG 
  701.                    files for the node, you must specify the exact location 
  702.                    of the config file you wish to modify.
  703. [configname.ext] - The name of the ZLABxxx.CFG file you wish to load. This 
  704.                    MUST be in the "ZLABxxx.CFG" format, with the "xxx" 
  705.                    replaced with the conference specific .CFG file you 
  706.                    wish to modify.  
  707.  {default}       - If you do not specify a file on the command line, 
  708.                    ZSET.EXE will create a file called "NONAME.CFG" in your 
  709.                    current directory.  After you have modified the default 
  710.                    settings to your specifications, be sure to save the 
  711.                    file under a proper ZLABxxx.CFG filename for the 
  712.                    conference you are setting up, and in the proper 
  713.                    location.  NONAME.CFG will be deleted when you exit.
  714.                                                        
  715.  
  716. II.  PCBoard's "TEMP" directory -
  717.  
  718. Line 179 of your PCBOARD.DAT file (maintained with PCBSETUP.EXE) is 
  719. critical to the operation of ZipLab Plus.  This is the "temporary" 
  720. directory in which (among other things) PCBoard holds the file 
  721. descriptions for uploads before they are actually posted.  This directory 
  722. MUST exist, and be EMPTY (don't use your root directory of your boot drive 
  723. like a couple of people have in the past!).  PCBSETUP WILL NOT CREATE THIS 
  724. DIRECTORY WHEN YOU EXIT, even though it does create just about every other 
  725. directory you specify if it doesn't exist.  This is just a quirk of 
  726. PCBSETUP, and it is up to you to be SURE this directory is both in 
  727. PCBOARD.DAT and that it exists.
  728.  
  729.  
  730.                                                                           Pg13
  731.   
  732. III. ZipLab Plus' "WORK" directory -
  733.  
  734. This directory is created (and removed) each time ZipLab Plus runs.  It
  735. is used to hold unzipped files and other temporary files while ZipLab is
  736. running.  By default, ZipLab creates a new directory under your current
  737. one (your PCBoard root directory in most cases) called .\ZLAB.DIR, which
  738. it removes when done.  If you want to redirect this to another drive
  739. (say a RAM drive for additional speed), set an environment variable 
  740. called "ZIPLAB" to the drive and directory name you wish.
  741.  
  742. SET ZIPLAB=E:\ZWORK
  743.  
  744. * Note!  This is another case where flexiblity is great, but can be 
  745.   dangerous if you don't pay attention.  Setting ZIPLAB= to oh, say the 
  746.   root directory of your boot drive - would have results which may cause 
  747.   you to think poorly of my program (and I of your mental capacity).
  748.  
  749.  
  750.                                                                           Pg14
  751.  
  752. ##############################################################################
  753.                         SOME NOTES ON MEMORY USAGE
  754. ##############################################################################
  755.  
  756. * NOTE!  Since PCBoard is SHELLING out to run PCBTEST.BAT, there is 
  757.   limited memory available for ZLAB.EXE.  If you are running in a 
  758.   multitasking or other memory constrained situation, ZLAB may not work! 
  759.   You should have at least 250k free memory when shelled out of PCBoard.  
  760.   If this is a problem, you may want to consider the VAROOM (overlay) 
  761.   version of PCBoard, which runs in considerably less memory than the 
  762.   standard PCB.EXE.
  763.   
  764.   The other option is to run PCBoard with the SET PCB = /SWAP environment 
  765.   variable.  This will cause PCBoard to "swap" its code to the best 
  766.   available storage (EMS, DISK) whenever a SHELL function (external 
  767.   protocol, viewfile, and even DOORS if you have the SHELL column in 
  768.   DOORS.DAT(LST) set to "Y") is called.  This method will cause a slight 
  769.   delay when SHELLING, but will provide the largest amount of available 
  770.   DOS memory for your external code.
  771.  
  772.  
  773.                                                                           Pg15
  774.  
  775. ##############################################################################
  776.                            PRODOOR DIFFERENCES         
  777. ##############################################################################
  778.  
  779. *  PRODOOR SYSOPS -
  780.    You will need to set up your PROUTEST.BAT file like this:
  781.                 
  782.    
  783.    @echo off
  784.    rem -- process test uploads request - for ProDOOR 3.44
  785.    rem -- %1-logfile, %2-testdir, %3-comport
  786.    
  787.    rem -- test each uploaded file individually
  788.    proecho %3 ~~Testing uploads.  Please wait...~
  789.    
  790.    SET PCBDOOR=PRODOOR
  791.    for %f in (%2\*.*) do COMMAND /c ZLAB %f d:\pcbpath d:\path\cfgpath 
  792.    SET PCBDOOR=
  793.    
  794.    :end
  795.  
  796.    Be sure you have enough ENVIRONMENT space to set up the PCBDOOR variable.  
  797.    If you are using DesqView, you may want to set PCBDOOR=xxxxxxx in your 
  798.    AUTOEXEC.BAT to be sure enough room is allocated in your DesqView 
  799.    partitions for this variable.  The x's will be replaced by PRODOOR when 
  800.    PROUTEST.BAT is executed.  I need this variable set to "PRODOOR", or ZLAB 
  801.    won't know you are running out of ProDoor.  You don't want to leave it set 
  802.    to PRODOOR though, since this could confuse things for other 
  803.    doors/processes. Thus the "SET PCBDOOR=" line.  ZipLab will fully work with 
  804.    ProDoor, including display/modification of the file descriptions.
  805.    
  806.              
  807. * Note!   Sam Smith has included an example PROUTEST.BAT/PROUT1.BAT 
  808.           with ProDoor, which as of this writing shows how to use 
  809.           ZipLab Plus 1.9c to do testing.  This WILL NOT work with 
  810.           ZipLab Plus 2.0, as the command line parameters for ZipLab 
  811.           have changed.
  812.           
  813.           Here is the relevant portion of PROUT1.BAT (called by
  814.           PROUTEST.BAT).
  815.           
  816.   rem -- test archives using ziplab plus by jeffrey s. morley
  817.   rem -- ziplab plus tests zip, arj, and lzh files
  818.   :test
  819.   addbidir %pcbdrive%%pcbdir%\$door.nam %TARGET%
  820.  
  821.   tm /l ptest %TARGET% u:\prod\ptest%PCBNODE%.cfg >>u:\prod\test%PCBNODE%.log
  822.   set PCBDOOR=PRODOOR
  823.   set ZIPLAB=T:\PTEST%PCBNODE%
  824.   cdto t:\scr%PCBNODE%
  825. ! ptest %TARGET% u:\prod\ptest%PCBNODE%.cfg
  826.   cdto u:\prod
  827.   set PCBDOOR=
  828.   if not exist %TARGET% del %dszlog%
  829.   if not exist %TARGET% goto end
  830.  
  831.   :end
  832.  
  833.  
  834.                                                                           Pg16
  835.  
  836.           The line I have marked with an "!" is the command line for
  837.           ZLAB.EXE and MUST be changed to read:
  838.           
  839.           zlab %TARGET% %pcbdrive%%pcbdir% u:\prod
  840.           
  841.           if you are going to use the sample PROUTEST/PROUT1 batch
  842.           files from Sam.
  843.           
  844.        
  845.                
  846.                                                                           Pg17
  847.  
  848. ##############################################################################
  849.                      VERSION HISTORY (NEWEST TO OLDEST)
  850. ##############################################################################
  851.  
  852.                          ZipLab Plus Beta 2.ß.1
  853.                         Version 2.0 beta version
  854.                            December 27, 1992
  855.                            
  856. First release of version 2.0 to wide-area beta.  Please, Please! read the
  857. documentation carefully, as well as the BETA.DOC file included.  Significant
  858. changes have been made to every part of ZipLab Plus, and none of your old
  859. executables or configurations will work without replacement or modification.
  860.                            
  861.  
  862.  
  863.                                                                           Pg18
  864.  
  865. ##############################################################################
  866.                       ABOUT ZIPLAB PLUS AND THE AUTHOR
  867. ##############################################################################
  868.    
  869. ZipLab Plus started out as a somewhat complicated batch file sometime in 
  870. 1989.  We all had been running PKUNZIP -t against uploads for some time, but 
  871. I wanted a batch file that would do a bit more, like use SCAN to test for 
  872. virus infection, reject old archives, and strip out .ZIP comments.  I also 
  873. wanted to present an interesting interface to the user, letting him/her 
  874. know what was going on in the program.
  875.  
  876. As the functions in ZipLab increased and became more complicated, it took 
  877. longer and longer to test files in the somewhat inefficient batch file 
  878. environment.  I then decided to port the program over to my programming
  879. language of choice (or at least default) QuickBasic 4.5.           
  880.  
  881. At this time I decided to make the program "shareware" to compensate for
  882. at least some of the time I was spending on the program.  I must say that
  883. ZipLab Plus has exceeded my expectations as a shareware offering, and I
  884. am grateful (and a little stunned) for the response by Sysops who have
  885. registered the program.  I had always heard figures like "only 5% or less
  886. of those who use shareware register", but if this is true then 10's of 
  887. thousands of sysops are currently using ZipLab Plus.  I don't believe that
  888. to be the case, and am instead inclined to believe that sysops, unlike
  889. doctors and lawyers, are NOT their own worst customers.
  890.  
  891. This program was written in QuickBasic 4.5, with some help from Hammerly 
  892. Computing's ProBas 4.01 and various home-grown assembly and C routines.  I 
  893. have included a few utilities which ZLAB will use in the course of testing.  
  894. These utilities are the property of the authors, and you are strongly 
  895. requested to register them if you continue to use ZIPLAB PLUS.
  896.  
  897.                              Jeffrey S. Morley
  898.                            The Interconnect BBS
  899.                                (703)425-2505
  900.  
  901.             PLEASE SEE REGISTER.DOC FOR REGISTRATION INFORMATION
  902.  
  903.                 (C)Copyright 1989-1993 by Jeffrey S. Morley
  904.  
  905.  
  906.